ATTR Syntax: Attr filename [permissions] Usage : Examine or 
change the security permissions of a file Opts: -perm = turn off 
specif ied permission perm= turn on specified permission -a = 

inhibi rms : d - directory file 
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from standard input 
working directory to 
ige: Change execution 
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current boot CONFIG 
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: Dsave [-G§$f|§llHM file 

to copy all files in a directory system Opts : -b make a system 
disk by using 0S9boot if present -b=<patb> = make system disk 
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After a successful call to open the file? the na^e of the file is printed on standard cut and then the function 
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if(argc < 2) /* check for at least 1 argufitent #/ 

else 

{ /* check if Offset zzrmeiz? */ 
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if(srge < 3) /* is there enough arguments */ 
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lined] = 46; 
printf(7.c B , lineEU); 



printf{ B \n a ); 
if(++i == 16) 



printf("\n\nM! 
headingt); 
i = 0; 



} 

headingt ) /* Heading - prints out the Heading at the top of each Block */ 

i 

prints "Address 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F ff ); 

printf( B 0123456789ABCDEF\n I )f 

print f ( " ■ ) ; 

pr intf ( B \n B ) i 

} 

formatO /* Format - print the correct format when needed */ 

{ 

fprintf (stderr," Incorrect argument List\nh>;d C -oof f set] filenameE filename]^'); 

} 

ooooooooooOOOOOOOOOOoooooooooo 

The 0S9 Operating System 



In the last two editions we touched on 0S9 module types, the kernel, bootstrapping the system and how to merge any 
selected user modules with the shell module. It does seem that at least some readers of the newsletter are 
interested in the comments presented. So if you can stand it, I will prattle on (to borrow Bob's description of my 
efforts) a bit more. 

It is hard to know just where to go from here, but perhaps a few comments on getting the most out of 0S9 would be 
in order, especially for the beginners. This also follows a theme set by Rosko in his well presented articles on 
Microware C. 

I will comment on 0S9 running on the CoCo systems as this probably covers most people new to OS?. 

Firstly, the hardware requirements that are desirable lead us to thoughts of a hard disk system, however such a 
system is probably not for everybody for a number of reasons, not the least of which is the price tag. We do need 
to consider just how far the budget will stretch or just what sort of investment we are willing to make. The 
decision we each make will also be influenced by our own reasons for running 039, or for computing at all. 

Well, I am one of those who has not as yet installed a hard disk system and can only look on with envy at those 
hard diskers, a la Don Berrie and many others in our group. 

O.K. so all this doesn't help you very much. A very workable and useful system can be achieved without a hard 

disk. 

Firstly you will definitely need two (2) floppy drives. Although 0S9 can be run on a single drive system, it is 

nothing less than painful, especially if that single drive is only 35 or 40 track single sided. 

The 0S9 operating system uses disk access a lot. So if you do want to run 0S9 and have a single drive system, then 
do yourself a favour and invest in a second drive. The frustration you will save yourself will be well worth the 
investment. I am running three (3) 80 track double sided drives, which although not quite my plan, have proven to 
be a great advantage. The number of disk changes I have to do is now greatly reduced, as I can boot from a system 
disk in drive 0, run applications from drive 1, and still have another drive for data disk or whatever. It is great 
to have a full CMDS directory sitting in drive 0, and be able to ' dsave 1 from /dl to /d2. 
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Now if you would like to see your favorite programme running even faster than it would on a hard disk system, a ram 
disk ui II speed things up no end. This is of particular advantage with such programmes as "Profile 1 or other 
databases. There is a public domain driver "rammer" and descriptor "rE H which can be added to the 0B9Boot. The 
CoCo3 system will need to have 512k to use this effectively. We have been using R0 to simulate a 35 tr single 
sided disk, which allows a 'backup' of a standard disk, and is a quick way of loading programmes or data files to 
the ram disk. The use of a ram disk for data of course has some risks as this is hardly a permanent record. When 
data processing is completed the updated files can be transferred to a floppy by a file copy or backup. The data 
on the ram disk rO can be recovered even after a re-boot of 059. If "iniz r0" is the first command in your startup 
file and "format /r0" is NOT included, the data previously stored will still be there, A simple 'dir /r0' will 
confirm this. Thanks to Don Eerrie for this discovery. Don also provided the source code for a VB" descriptor 
that allows it to be used with D.P.Johnson's "SDisk3"; refer to our July 'SB newsletter. 

Just a brief aside before I move off disk drives. As I said, my system was not planned around 3 >: 8S track drives. 
Two drives worked just fine apart from the fact that the S3 track drives could not conveniently read a standard 
35tr. RS Dos disk. So, as many CoCo owners have been using TEAC FD55F 80 tr drives which could easily be made to 
simulate 46tr mode by simply switching out a particular resistor on the drive board, I decided to take the plunge 
and order such a drive. TEAC have revised the FD55F to such an e>;tent that we have not been able to find a method 
of the desired mode switching. Has anybody cut there found a simple solution to this problem? 

If you are using a CoCo 1 or CoCo 2 you will of course be running 0S9 Level 1 with 64k of memory. Beyond this you 
can add extra memory which is usable only as a ram disk. This does add some advantage to level 1, but unless you 
have already made this modification, I would suggest that the purchase of a CoCo 3 or perhaps something else would 
be a better way to go. 

If you already have a CoCo 3 and have not added a 512k upgrade, then may I suggest that you do. The Microware 0S9 
level 2 distributed by Tandy for the CoCo 3 almost demands this 512k. I say almost because it will run on a 123k 
computer, but you will very quickly find that multitasking is extremely limited. 

In summary then, two disk drives are a must, 512k on a CoCo 3 is also a must. Now you will be able to get close to 
running 0S9 the way Microware intended it. You will soon find however, that the CoCo hardware, in particular the 
operation of the disk controller, will severely limit multitasking. The Tandy disk controller interface uses 
interrupts of the processor which prevents any other processing to take place whilst a disk drive is being 
accessed. The result is that you find yourself waiting for each disk access to complete before you can do 
anything. The 0S9 clock module will not keep correct time for this very reason. 

Now there is an answer to this problem. It does require the parting with a few more dollars though. I have 
recently added a 'no-halt' controller to my CoCo3 system which has resulted in such an improvement that I can only 
describe it as MAGIC. I have the "Disto" controller manufactured and distributed by CRC COMPUTERS Montreal, 
Canada. 

This controller works on all CoCos 1, 2 & 3 with or without the Multi-Pak interface. The controller comes with 
special device drivers needed to utilize the special buffered mode. This uses memory installed in the controller 
so that all sectors being written to or read from the disk will be done via a sector buffer. The result is that 
the 6329 is not halted between bytes, and you are able to fly along without waiting for the CPU to allow reading of 
the keyboard or anything else for that matter. The manual does warn that you should not do anything else whilst 
formatting a disk because 'format' takes up almost all the processor time. Well warnings are there to be ignored 
aren't they. I have carried on running other processes whilst in the middle of a format without problems, although 
things do slow down noticeably. 

I have been sidetracked this month and not covered much of the operating system as such, but I do hope that my 
comments en the desirable hardware will help some of you to make your venture into 0S9 a little more enjoyable. 
Next month I will try to return to the subject of the 0S9 operating system. Perhaps a short note to us with a 
suggestion on what you need to know will get me back on the track. 

Gordon Bentzen 
odooooqoooOOOOOOOOOOoooooodooo 
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Motor On modifications for FD502 disk drives 
A further note by Bob Devries. 

In last months issue I mentioned the jumper change necessary for the Tandy FD series disk drive, to allow the 

motor-on signal to turn on the drive motor instead of the select signal , which would otherwise create problems 

especially under 0S9. I have since found out that the change I described was for the FD501 drive only. 

Here is the modification for the FD502 drive. The main control board' has a jumper marked '5' which needs to be 

moved to the alternate position also marked J 5\ Unfortunately, the board needs to be removed to change the jumper. 

To do this, remove the three plugs near the 34 way connector* being careful with the two flimsy plastic ones. The 

three conductor piactic one needs to be released by prising up the white plastic collar that holds it, and then 

removing the lead. Undo the three screws and remove the board, not that it is still held by the motor connexions. 

Remove that connector also. 

Locate the jumper marked '5' next to the 34 way connector, and remove the link. Solder a new link into the 

alternate position, and you're all done. Re-assemble the board to the drive, and re-install the connectors. 



ooooooooooOOOOOOOOOOOooooooooooo 



PROBLEMS WITH DSAVE 



I have two single sided disk drives and at one time I was running only 35 tracks with a slow stepping rate. After 
talking to fellow 039'ers I realised that my drives can cope with 40 tracks and h millisecond stepping rate. Eewdy 
I thought, more disk space. 

I got hold of a 40 track boot disk through the local user group and promptly set out to reformat all my 0S9 disks 
and transfer all the files onto the newly formatted disks. Easy - just type backup /dB /dl and away you go. Like 
fun. The error message comes up with "disks not formatted the same!". Well of course not, thats the whole idea' I 
was now in a dilemma - what can I do. I could try copying one file at a time but that would take from now to 
eternity to accomplish! I know what to doi Til go BACK to RS-DOS and use the basic command "BACKUP' but that 
didn't work too well either. 

I rang Bob Devries and asked him what I should do. He said to use DSAVE. "What is DSAVE?" I enquired. The 
answer is what I wanted to hear "Well DSAVE is a command in your CMDS directory and is specifically designed to 
transfer files from differently formatted disks." "THANK YOU BOB" was my reaction and away I went to use my new 
found knowledge. 

r 
Into drive goes my 35 track system disk and into drive 1 goes the newly formatted 40 track -disk. Then I followed 

the instructions given to me. DSAVE ,'d0 /dl ! SHELL . What a bewdy! Its working! ' My files are being transferred 

all by them selves. What's that! ERROR 244! Not to worry only one out of a hundred files. Oops not again - another 

error ERROR 243 Oh no not another! Well DSAVE seemed like a good idea at the time. I know what to do. Just write 

down the files that DSAVE didn't copy properly and copy them in 'long hand' later. After copying ten files across 

I finally had a system disk on 40 tracks. 

Proud of my new aquisition I went to work on it. First thing I did was to boot up with it. Everything was fine 
until the startup file tried to read the PRINTERR file and came up with the dreaded ERROR message. ERROR 214 NO 
PERMISSION. What's all that about 1 PRINTERR with no permission. Bull! Well lets use ATTR PRINTERR and see. 
ds_wr_wr is what came up. No can't be - PRINTERR is not a directory. Oh well its easy to fix. DELDIR 
/d0/CMDS/printerr is the logical answer. Guess what - it didn't work! I tried to use ATTR PRINTERR -D but that 
didn't work either. Nothing I could do would allow me to change the file or delete the file! AH I could do was 
to rename it. SO I did - I called it RINTERR, then I copied the file into the command directory from my backup 
disk. I took a closer look at other files and found that several other files were also "directories". I could not 
delete them either. 

This problem had me bamboozled for a long time. I would ask people for help but no-one could help me. Now what 
can I do? 
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Well it so happened that one of the ladies at work had an old full height disk drive (bare) that her hubby couldn't 
get to work, She gave it to me to give to my boys for final destruction, I didn't give it to the boys but took it 
to a friend' 5 place to try to resurrect it. While we worked on it quietly, I noticed that when he addressed drive 
the motor on drive 1 would start up. How come? It seems that 0S9 requires it as it does not all oa? time for the 
drives to get up to speed. When using BACKUP or (wait for it) DSAVE it may corrupt the disk being written to 
because it is trying to write to a disk that is not up to speed yet! Sounds too good to be true! 

Off home I went to once again apply my knowledge. Off came the diskdrive cover and in went the fingers. Would you 
believe it. fly TANDY drive is not latched with the Chinon drive. So I found out how to latch it. On the circuit 
board is a jumper link i similar to the one to select the drive number) with another pin next to it. The extra pin 
had been cut off. I soldered another pin on and relocated the jumper link. Now when either drive is addressed the 
other drive motor starts up. Fantastic! 

Quick. Out with 0S9 system disk. Try DSAVE. HURRY! Well it seems to be working but don't get your hopes up too 
high. DSAVE went right through the system disk WITHOUT any errors! Amazing ain't it. I can now run SDISK and a 
couple of other programmes that address two drives without any problems. 

Now I am a happy little 0S9'er once again and keen to use commands such as DSAVE as much as possible. Sc to anyone 
else who is having trouble with DSAVE - just check that the your drive motors are latched. 



Peter Barendrecht. 

ooooooooooOOOOOOOOOOoooodoogooo 

A Database in C. 

By Bob Devries 

This is part three of my database programme in C. The two functions printed here draw the data mask on the 
screen* and put the current record into the blanks. 

The function scrnmaskO only prints to certain locations on the screen and clears the screen of a previous 
data record. The function scrndataO reads the a record* whose number is given in the recno parameter passed to it, 
and prints each field in its correct location on the screen. 

Here then is this month's code. 

scrnmaskO 

/* scrnmaskO clears the screen and draws the mask of the data boxes with */ 

/* their titles */ 

{ 

cursortS^S); /* position cursor */ 

printf( a Surname E 3 B ); /* print field contents */ 

cursor (40*5); 

printfPFirstname E P>; 

cursor (5* 7) i 

printfl 'Street C ] B ); 

cursor (5* 3) ; 

printfOCity E 3"); 

cursor (5* 9); 

printfCState E 3") 5 

cursor (5, 10); 

printf( "Postcode [ ]■); 

printfP\n\n\n H ); 

} 



scrndata(recno) 
int recno i 



^cje 
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/* scrndataO reads the current recno froa the file and prints it on the */ 

/* screen in the alloted places */ 

< 

if (recno < 1) /* test to see if you've gone too far back */ 
recno =1; /* and set to one if so */ 

fseektfp, (long) ( (recno- i)*sizeof (sail) ),0); /* goto record nuaber */ 

fread(&aail,sizeof(aail),l,fp); /* read the data in */ 

scrnaaskO; /* clear the screen of old data */ 

cur sort 14, 5); /* position cursor */ 

printf("Xs",aail.surnaae)s /* print the field contents */ 

cursor (51,5); 

printf("Xs fl ,aail.firstnaae); 

cursor (13, 7); 

printffXs", aail. street); 

cursor (11,8); 

printffXs", Bail, city); 

cursor (12, 9); 

pr intf ( "Xs" , aai 1 . state) ; 

cursor (15, 10); 

pr intf ( u YM m , mai 1 . postcode) ; 
> 



ooo«x>ooooOO(X)GOCOX)oococooooo 



SETTING THE ENVIRONMENT FOR YOUR C COMPILER 

Trie following short Basic09 prograaae arose froa a conversation Nith Bob Devries. Me were discussing probleas 
relating to the Hicroware C Coapiler, and it's lack of any aethod to autoaatically include graphics, and other 
library support. This problea is caused by the fact that ccl (or the patched "cc2" version .. see Septeaber 1988 
Newsletter) writes a procedure file, c.coa, which handles all of the sequential steps of preparation, coapiling, 
optoaizing, assembly and linkage. Unless you physically edit this file to include other library resources, the 
linker will generate "unresolved reference" error aessages when you try to call functions which are not in the 
standard library. 

We figured that the best way to achieve this was to use the -r option with the existing coapiler, and then add the 
necessary library options via a Basic09 procedure. As an added feature, we thought that it would be nice to 
include full pathnaaes to the relevant directories. This will sake it especially useful for hard disk users. One 
thing you will have to reaeaber, however, is that the standard coapiler looks in the directory /dl/DEFS to locate 
its Sinclude files, when they are enclosed in O's, as in f include <stdio.h>. If you plan compile programs outside 
those specific directories, you will need to provide full pathnaaes in your source code, and enclose thea in 
parenthesis, eg tinclude "/HO/COMPILER/DEFS/stdio.h". I also have included sufficient error trapping so that if 
there is a problea, you won't be left with ayriad overlay windows hanging around. 

At about the saae time, I had also been fiddling with some interesting screen aanipulation techniques, so I decided 
to include an exploding window effect which is well worthwhile having a look at, even if you are not interested in 
trie environment setting part of the prograaae. 

The prograaae also attempts to save the pathnaaes (again for hard disk and 80 track drive users) to a directory 
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naned SYS in the root directory of the device containing the current data directory. Boy, what a ■outhful. But 
think about it. The whole thing is designed to run in an 80 coluan window, and will need the gfx2 graphics support 
nodule in nenory, or in trie execution directory. It also stakes a couple of other system calls, so it will also 
need to have access to then. You'll see the SHELL calls in the source code. There is just one caveat. Re*eaber, 
this was an extreiely rough and quick exercise, and therefore I cannot gaurantee that there are no hidden errors or 
other hiden lurkers. There is at least a framework for some pretty neat inprovesents. I look forward to seeing 
sote aodif ications frost within our sieabership. 

If you would like to discuss the programme, I will be only too happy to talk to you. Please contact le on (07) 
375-3236. 

Cheers Don Berrie. 



PROCEDURE env»afcer 

RUN explode 

DM fpath, flag: BYTE 

DIMcfile,rfile:STRINGI301 

DIM keypress:STRIN6[31 

DIM errno: INTEGER 

DIM libpath,cwfepath,sourcepatri:STRINGt301 

PRINT 

PRINT "Searching for /SYS/ccasp.env" 

PRINT 

ON ERROR SOTO 10 

OPEN f fpath/ /SYS/ccoRp.env":READ 

ON ERROR 
PRINT 
GOTO 15 
10 errno=ERR 
OH ERROR 
IF errno=216 THEN 

PRINT "Environswmt directory/file not found" 
ENDIF 
PRINT 

PRINT "Input pathname for library files (eg. /HO/USR/LIB. . . ) :"; 
INPUT libpath 
PRINT 

PRINT "Input pathname for Compiler 0"©S directory :"; 
imn cadspath 

PRINT 'Input pathname for Conpiier source directory i"; 
INPUT sourcepath 

PRINT "Create er.viroraent file (Y/N) :"; 
INPUT keypress 
IF keypress="Y" OR keypress="y° T*€N 

CREATE tfpath," /SYS/ccosp.env": WRITE 

WRITE tfpath, libpath 

WRITE tfpath, cadspath 

WRITE tfpath, sourcepath 
ENDIF 
GOTO 18 
15 READ If path, libpath 
READ tfpath, cadspath 
READ tfpath, sourcepath 
18 CHD sourcepath 
CHX csKtepath 
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PRINT "Input filename to compile :"; 

ON ERROR GOTO 100 

imn cfile 

PRINT 

PRINT "Is graphics support required (Y/N) :"; 
20 INPUT keypress 

keypress=LEFT$ (keypress, 1 ) 

IF fceypress= n Y" OR keypress='y" THEN 

flag=l 

GOTO 25 

ENDIF 

IF keypressO'N" OR keypressOV THEN 

GOTO 20 

ENDIF 

flag=G 
25 SffiJ. "cc2 "+cfile+" -r" 

rfile=LEFT$(cfile,LEN{cfile)-2)+\r" 

PRINT Mink;" 

IF f lag=0 TtO 

SHELL Mink Mibpath+Vcstart.r -+rfile+" -o='+LEFT$(cfile,LEN(cfile>-2)+" -l="+libpath+Vclib.l" 

ELSE 

SHELL Mink "+libpath+"/cstart.r "♦rfileV -o="+LEFT*<cfile,LEN(cfile)-2)+" -l='+libpath+"/clib.l 
l=Mibpath+Vcgfx.l -l="+libpath*"/sys.r 

ENDIF 

SHELL 'del c.coV 

SHELL "del "+rfile 

RUN unexplode 

PRINT "Prograa successfully compiled" 

CLOSE tfpath 

END 
100 RUN unexplode 

CLOSE tfpath 

ON ERROR 

PRINT "ERROR - Program not compiled" 

SHELL "del "+rfile 

SHELL "del c.com" 

END 



PROCEDURE explode 
RUN gfx2("owset", 1,39, 11,2,2,5,5) 
RUN gfx2( B ottset", 1,29,8,22,8,5,5) 
RUN gfx2fowsetM, 19,5,42, 14,5,5) 
RUN gfx2("o»sef, 1,9,2,62,20,5,5) 
RUN gfx2<'owset",l, 0,0,80,24,2,5) 
RUN gfx2("owset H , 1,2,1,76,22,2,0) 



PROCEDURE unexplode 
DIM i: INTEGER 
FOR i=l TO 6 
RUN gfx2("owend") 
NEXT i 
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